package com.danciyixue.boot.dcyx.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.danciyixue.boot.dcyx.model.entity.UnitStudyStats;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.danciyixue.boot.dcyx.model.query.UnitStudyStatsQuery;
import com.danciyixue.boot.dcyx.model.vo.UnitStudyStatsVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

/**
 * 单元学习统计Mapper接口
 *
 * @author youlaitech
 * @since 2025-06-15 16:32
 */
@Mapper
public interface UnitStudyStatsMapper extends BaseMapper<UnitStudyStats> {

    /**
     * 获取单元学习统计分页数据
     *
     * @param page 分页对象
     * @param queryParams 查询参数
     * @return {@link Page<UnitStudyStatsVO>} 单元学习统计分页列表
     */
    Page<UnitStudyStatsVO> getUnitStudyStatsPage(Page<UnitStudyStatsVO> page, UnitStudyStatsQuery queryParams);

    /**
     * 根据用户ID和单元ID查找单元学习统计记录
     *
     * @param userId 用户ID
     * @param unitId 单元ID
     * @return 单元学习统计记录
     */
    UnitStudyStats findByUserIdAndUnitId(@Param("userId") Long userId, @Param("unitId") Long unitId);

}
